home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / rcsclean.z / rcsclean
Encoding:
Text File  |  2002-10-03  |  7.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RRRRCCCCSSSSCCCCLLLLEEEEAAAANNNN((((1111))))                                                        RRRRCCCCSSSSCCCCLLLLEEEEAAAANNNN((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rcsclean - clean up working files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rrrrccccsssscccclllleeeeaaaannnn [_o_p_t_i_o_n_s] [ _f_i_l_e ... ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      rrrrccccsssscccclllleeeeaaaannnn removes files that are not being worked on.  rrrrccccsssscccclllleeeeaaaannnn ----uuuu also
  16.      unlocks and removes files that are being worked on but have not changed.
  17.  
  18.      For each _f_i_l_e given, rrrrccccsssscccclllleeeeaaaannnn compares the working file and a revision in
  19.      the corresponding RCS file.  If it finds a difference, it does nothing.
  20.      Otherwise, it first unlocks the revision if the ----uuuu option is given, and
  21.      then removes the working file unless the working file is writable and the
  22.      revision is locked.  It logs its actions by outputting the corresponding
  23.      rrrrccccssss ----uuuu and rrrrmmmm ----ffff commands on the standard output.
  24.  
  25.      Files are paired as explained in cccciiii(1).  If no _f_i_l_e is given, all working
  26.      files in the current directory are cleaned.  Pathnames matching an RCS
  27.      suffix denote RCS files; all others denote working files.
  28.  
  29.      The number of the revision to which the working file is compared may be
  30.      attached to any of the options ----nnnn, ----qqqq, ----rrrr, or ----uuuu.  If no revision number
  31.      is specified, then if the ----uuuu option is given and the caller has one
  32.      revision locked, rrrrccccsssscccclllleeeeaaaannnn uses that revision; otherwise rrrrccccsssscccclllleeeeaaaannnn uses the
  33.      latest revision on the default branch, normally the root.
  34.  
  35.      rrrrccccsssscccclllleeeeaaaannnn is useful for cccclllleeeeaaaannnn targets in Makefiles.  See also rrrrccccssssddddiiiiffffffff(1),
  36.      which prints out the differences, and cccciiii(1), which normally reverts to
  37.      the previous revision if a file was not changed.
  38.  
  39. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  40.      ----kkkk_s_u_b_s_t
  41.           Use _s_u_b_s_t style keyword substitution when retrieving the revision
  42.           for comparison.  See ccccoooo(1) for details.
  43.  
  44.      ----nnnn[_r_e_v]
  45.           Do not actually remove any files or unlock any revisions.  Using
  46.           this option will tell you what rrrrccccsssscccclllleeeeaaaannnn would do without actually
  47.           doing it.
  48.  
  49.      ----qqqq[_r_e_v]
  50.           Do not log the actions taken on standard output.
  51.  
  52.      ----rrrr[_r_e_v]
  53.           This option has no effect other than specifying the revision for
  54.           comparison.
  55.  
  56.      ----TTTT   Preserve the modification time on the RCS file even if the RCS file
  57.           changes because a lock is removed.  This option can suppress
  58.           extensive recompilation caused by a mmmmaaaakkkkeeee(1) dependency of some other
  59.           copy of the working file on the RCS file.  Use this option with
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRCCCCSSSSCCCCLLLLEEEEAAAANNNN((((1111))))                                                        RRRRCCCCSSSSCCCCLLLLEEEEAAAANNNN((((1111))))
  71.  
  72.  
  73.  
  74.           care; it can suppress recompilation even when it is needed, i.e.
  75.           when the lock removal would mean a change to keyword strings in the
  76.           other working file.
  77.  
  78.      ----uuuu[_r_e_v]
  79.           Unlock the revision if it is locked and no difference is found.
  80.  
  81.      ----VVVV   Print RCS's version number.
  82.  
  83.      ----VVVV_n  Emulate RCS version _n.  See ccccoooo(1) for details.
  84.  
  85.      ----xxxx_s_u_f_f_i_x_e_s
  86.           Use _s_u_f_f_i_x_e_s to characterize RCS files.  See cccciiii(1) for details.
  87.  
  88.      ----zzzz_z_o_n_e
  89.           Use _z_o_n_e as the time zone for keyword substitution; see ccccoooo(1) for
  90.           details.
  91.  
  92. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  93.           rrrrccccsssscccclllleeeeaaaannnn  ****....cccc  ****....hhhh
  94.  
  95.      removes all working files ending in ....cccc or ....hhhh that were not changed since
  96.      their checkout.
  97.  
  98.           rrrrccccsssscccclllleeeeaaaannnn
  99.  
  100.      removes all working files in the current directory that were not changed
  101.      since their checkout.
  102.  
  103. FFFFIIIILLLLEEEESSSS
  104.      rrrrccccsssscccclllleeeeaaaannnn accesses files much as cccciiii(1) does.
  105.  
  106. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  107.      RRRRCCCCSSSSIIIINNNNIIIITTTT
  108.           options prepended to the argument list, separated by spaces.  A
  109.           backslash escapes spaces within an option.  The RRRRCCCCSSSSIIIINNNNIIIITTTT options are
  110.           prepended to the argument lists of most RCS commands.  Useful
  111.           RRRRCCCCSSSSIIIINNNNIIIITTTT options include ----qqqq, ----VVVV, ----xxxx, and ----zzzz.
  112.  
  113. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  114.      The exit status is zero if and only if all operations were successful.
  115.      Missing working files and RCS files are silently ignored.
  116.  
  117. IIIIDDDDEEEENNNNTTTTIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  118.      Author: Walter F. Tichy.
  119.      Revision Number: 5.7; Release Date: 1998/01/12.
  120.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  121.      Copyright c 1990, 1991, 1992, 1993 by Paul Eggert.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RRRRCCCCSSSSCCCCLLLLEEEEAAAANNNN((((1111))))                                                        RRRRCCCCSSSSCCCCLLLLEEEEAAAANNNN((((1111))))
  137.  
  138.  
  139.  
  140. SEE ALSO
  141.      ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1),
  142.      rlog(1), rcsfile(4), RCSsource(5)
  143.      Walter F. Tichy, RCS--A System for Version Control, _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e &
  144.      _E_x_p_e_r_i_e_n_c_e 11115555, 7 (July 1985), 637-654.
  145.  
  146. BBBBUUUUGGGGSSSS
  147.      At least one _f_i_l_e must be given in older Unix versions that do not
  148.      provide the needed directory scanning operations.
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.